nitoTV version 0.5.5 (take two), Sep 20th, 2008.

Version History
===============

0.5.5 The DVDPlayback.framework is BACK!! (thanks Turbo!!) and the Smart Installer got some major adjustments. (You will need to run the Smart Installer again before the DVDPlayback framework will work) Fixed an extension controller bug where no new extensions would be added, various other tweaks and bug fixes.

0.5 Various major/minor bug fixes, cleaned up UI in few sections, QuickTime text display is back, QuickTime audio/sub toggling back. Time displayed in title (think iPod/iPhone title/time display), Metadata makes a comeback, Added atomic parsley to fetch metadata directly from mp4 files where applicable. Added hold left and hold right to toggle subs and audio in libdvdnav based playback, Added MPlayer resume.

0.4.8 AppleTV OS 2.1.0 works for real this time!, honest!

0.4.7 Only three changes: adjusted Smart Installer for the patch, loads in 2.1.0, new modes in safe display release.

0.4.6 Pretty quick follow up release, found a major bug with the Smart Installer re: mouse enabling that prevented the installer from finishing. Some great App Launcher enhacements, keymaps (identical to mplayer setup) can now be edited in the new keymap editor!, smart/safe display release code added as well.

0.4.5 Initial Application Launcher implementation, watchdog/USB patches for smart installer (2.0-2.0.2), Smart installer modifications / improvements. Install Software section works without internet (only on those packages applicable without internet) Fixed empty / unlistable folder bug, finder system icon display.

0.4 Photo playback improvements, libdvdnav re-emerges, Independent OpenAL installer, Added settings to turn off unplayed markers and preview generation. Updated patches for 2.0.1 USB in smart installer, Settings images, file copy/paste, playlist enhancements (re-arrange, move to top/bottom), kextloader and smart installer merged, custom network arguments (for mounting) and of course bug fixes.

0.3.1 Major bug fixes (fixPerm works again) Updated smart installer to work from restore images, Cover Art returns. unplayed markers return.

0.3 Bug fixes, tweaks, more features restored, ability to turn off POD, RSS and Weather from menu

0.2.2 Has some major fixes, finally updated to full take 2 to investigate some of the installer problems, and im happy to report that the Smart Installer AND Perian installer both work in Take 2 full now! Those are the main changes for 0.2.2.

0.2.1 Has one minor fix, there was a missing file that was causing the smart installer to throw an error, this file has been included so HOPEFULLY the installer should work for everyone now.

General Update Info 0.5.5
===================

NOTE: Just going to continue to leave the old update informations below until I actually have time to revise the wiki. 

DVDPlayback framework
=====================

DVDPlayback.framework finally makes it's debut in 2.x based nitoTV!!! (yes nitoTV should still work in 2.0.1-2.1.0) The main thanks goes to Turbo for getting this framework back in action, surprisingly there was very little code changed in the plugin to maintain the functionality, the work that was needed was on the kernel level. For anyone who is familiar with how the framework functioned in 1.x versions the functionality is identical. 

DVD Keymaps: These particular keymaps are only relevant with the DVDPlayback framework installed. Pressing and holding menu will change to the second keymap, < and > will remain the same but + will toggle through multiple audio tracks and - will toggle through multiple subs. (this is the same from before, just reinterating it or putting it out there for those unfamiliar)

DVD Alerts: DVD alerts are back same as before in 1.0, any time you are in the File section of nitoTV and a DVD is inserted you will get the option to play, import or list the titles of said DVD.

DVD Importing: No enhacements or improvements, same as before. (still need to reimplement growl notifications)


Smart Installer
===============

The smart installer had some nice improvements and changes, it MUST be run (even if you have run it before) to get the DVDPlayback framework to work again, in addition, if the recovery.dmg (From a 1.0 AppleTV) and the 10.4.8/10.4.9/10.4.10 combo update (I recommend 9) will install everything necessary to mount DVD's, ISO's and music CD's (music playback / cd importing to come later)

It will also fix permissions and owners that I have overlooked in the past which are instrumental to getting UI scripting working (needed for game emulators)

Random Notes / Bug fixes
=======================

Adding extensions in the extension manager should work again

if networking components are not installed nitoTV will no longer crash but will present an error message that they are missing.

Changed back to the 0.4.8 model of Kerberos check, 0.4.8 wasnt far enough and 0.5 was too overzealous, for now it will error in the console but won't prevent the mount from proceeding if a framework that could be problematic is found.

Rewind during emulator will take a screen shot again

Hold Rewind in the file browser will regenerate images again.



General Update Info 0.5
===================

There is still some relevant information below in the updates for 0.4.6 and 0.4.5 that hasn't been added to the wiki or anywhere else so I'll let them intact here until there is a chance to add them elsewhere.

QuickTime Changes
=================

QuickTime playback saw a nice overhaul in this version, we have the return of text info displays (volume muted, max, keymap changes, subs/audio toggling, file titles), sub/audio toggling has returned as well.

There have been some bug fixes as well, unplayable files wont crash anymore they will show the default unplayable dialog, unfortunately this gave rise to another bug (nothing major) menu needs to be pressed twice to get back to the file listings, a minor inconvience that I couldn't find a timtely workaround to.

Resume times have also been fixed as well, there are files that would not resume properly if the resume time was too close to the end of the total duration.

Metadata
========

Metadata has finally made a comeback, was a terribly small oversite on my part that it wasn't working the first time I tried with earlier versions. The support is still limited to mainly the same tags that worked in 1.x based versions. Certain tags still aren't cooperating (episode/season numbers in TV shows for instance) Those will hopefully be smoothed out in the next release.

Atomic Parsley has been incorporated to read some basic tags direclty from applicable files (mp4, m4v, etc...) It does not read all the tags yet, just some basic ones. This will be expanded in the future, just wanted to lay the groundwork. Currently only the following tags are supported 

	mediaType
	title
	artist
	description
	genre

Time In Title
=============

Similiar to the iPod classic setup where the time will be displayed in the title area after 30 seconds. This can be turned off in the settings.

MPlayer Resume
==============

This implementation is a little buggy, some file formats have some timing issues (it appears to be based on bizarre framerates) that will try to resume later then they actually should, which causes some files to not play back at all when attempting to resume, this is why there is an option to turn MPlayer resume off and on till it can be honed a bit better.

General Notes
=============

There was some major cleanup work done and various bugs fixed as well in this release, really wanted to work on the stability and make the plugin less crashy and more reliable. The following bugs have been addressed (and i may have forgotton some as well)

Playlist unselectable - after switching through files in a QuickTime based playlist subsequent playlists wouldnt be selectable. This has been "fixed". It wasn't a legit fix, more of a workaround, but it works.



General Update Info 0.4.6
===================

Since this update is so close on the heels of 0.4.6 we'll leave the 0.4.5 information intact in here because it is still pretty valuable.



There is a new keymap editor for MPlayer in the settings facade (where 'reset controls' used to reside), this keymap editor also works for Applications, just hit the ff/next button on the remote on the app of your choice, continue through "edit controls" and assign key maps as you please. If you want a command sent be sure to put it in lowercase, will also respond to words "up, down, left, right, return, tab, delete" to emulate these buttons on the keyboard. For right now, unless its one of the words about (left, right, etc) every other command with be sent with the command button (this will be expanded in the future)

We also added a little amber blink (blinks twice) when keymaps are changed (added in MPlayer mode as well) to better indicate when the changes take place

And last (but certainly not least) we added some "safe display" code, this code will check for resolutions that have trouble relinquishing the display (720p and 1080p) and switch to a lower more stable resolution (1080i etc) before attempting to release the screen. This works with both MPlayer and application launching, this feature can be toggled in settings: "Safe Display Release"

This goes somewhat in tandem with the new "Safe Display Startup" setting, this setting will force the AppleTV into a resoution deemed "safe" upon startup of the Finder. This setting is mainly there for those "oops" moments when you switch TVs and forget to put it at a safe resolution for the TV you are switching to.


General Update Info 0.4.5
===================

0.4.5 introduces initial Application Launching support. There is an option to enable an Application category for the main menu in the settings facade (similiar to how RSS, Weather, POD are enabled). The Applications folder defaults to /users/frontrow/Applications (~/Applications) This can be changed in the terminal settings but not via the GUI yet. To open a particular file in a program installed in your ~/Applications folder you can browse to it from the Files section. It is important to launch the application at least once before trying to launch a file in it. Using menu will exit the current application, if the application crashes menu will still exit back out to the main menu.

NOTE: as of right now we have NOT implemented the fire and forget, quit finder or remote watcher aspects of the App launcher, those will (pending which ones have demand) make it into subsequent releases.

Installer Changes
==============

The smart installer will now check the USB/Watchdog patch prior to doing file install checks, this is necessary for those who have 1) already installed the software and just want the watchdog patch, or 2) those who haven't actually copied a disc image in place for file installation (or deleted said disc image) can still get the watchdog patch.

The empty folder selection bug is fixed, a dialog will appear mentioning an empty folder, or a folder with no supported suffixes.

USB patch updated for 2.0.2, also covers watchdog, and will apply to 2.0.1 and 2.0 for any late updaters.

Display Changes
============

While in 1080i 720p files will have -monitoraspect 16:9 added to properly fill the screen

Finder Icons will be displayed for any items missing a cover image based on their finder CoreTypes.bundle based icon. This can be turned off in settings (it can slow down browsing slightly from time to time) 

WARNING: It is not recommended to swap in a full Leopard based CoreTypes.bundle, it will work to replace the icons at first, but after reboot most icons only display as the generic document icon.

However, it IS possible to just grab some choice images from the Leopard bundle and replace the original Tiger based ones, make sure to backup the original CoreTypes.bundle just in case. The following are some images of notice that can be replaced.

	ApplicationsFolderIcon.icns
	com.apple.mac.icns
	DesktopFolderIcon.icns
	DeveloperFolderIcon.icns
	DisconnectedFileServerIcon.icns
	DocumentsFolderIcon.icns
	GenericAirDiskIcon.icns
	GenericFileServerIcon.icns
	GenericFolderIcon.icns
	HomeFolderIcon.icns
	LibraryFolderIcon.icns
	MovieFolderIcon.icns
	MusicFolderIcon.icns
	OpenFolderIcon.icns
	PicturesFolderIcon.icns
	PublicFolderIcon.icns
	SitesFolderIcon.icns
	SmartFolderIcon.icns


Potential code re-writes: 
=========================

NONE! We are almost back on track to bring all the features in 1.x based versions into Take 2.


Future Consideration
====================

The following should be addressed in the future pending time to do it.

Improved metadata support / cataloging / fetching
Nicer weather / RSS setup
Parental Controls
resume or start from beginning menu


Special Thanks
==============

 Turbo (kext loader / SSE3 emulation)
 ak2007 (for App Launcher source to help integrate app launching into nitoTV)
 brandon holland (for various example code for porting to Take 2)
 ben mackin (for informative take 2 wiki and info for USB patch)
 jim dovey a.k.a. alan quatermain (always gets a shout)
 Sapphire team (for open source leopard porting info)
 mplayer team (for mplayer)
 ffmpeg team (for ffmpeg)
 Richard Bannister (for emulators)
 jrhelp32 (offset update for 2.0.1 USB patch)
 atomic parsley team (for atomic parsley)
 
Legal
=======
 
nitoTV Copyright  2007-2008 nito llc.
All rights reserved.

SSE3 emulator and kextloader copyright 2007-2008 by Mike Byrne (turbo@0xfeedbeef.com)

Portions Copyright (c) 2007-2008 Jim Dovey (aka AQ)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, publish, and/or distribute copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

No fees may be charged, no bundling the software and no dynamic downloading with commercial patchsticks without explicit written permission.

We are not affiliated with any commercial patchstick projects and reserve the right to deny support for any AppleTV's modified from said projects.